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NOTICE 
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DISCLAIMER OF ALL WARRANTIES AND LIABILITY 
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is believed to be reliable; nevertheless, Nestar Systems, 
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respect to this manual or with respect to the software described 
in this manual, its quality, performance, merchantability, or 
fitness for any particular purpose. The entire risk as to its 
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Incorporated software is licensed "as is." The terms and 
conditions under which programming errors will be corrected are 


described in the Software License Agreement for the product. 
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direct, indirect, incidental, or consequential damages resulting 
from any defect in the software, even if Nestar Systems, 
Incorporated has been advised of the possibility of such 
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implied warranties or liability for incidental or consequential 
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HOW TO USE 


How To Use This Manual 


The MESSENGER (tm) Electronic Mail System, (Nestar Systems, Inc., 
Product Number A-2802), is a program that allows messages to be 
created, sent, received, and filed using the Nestar Cluster/One 
Model A network. Messages are composed and edited using Apple II 
user stations, and are stored on disks managed by the Network 
File Server (NFS). 


User stations for the MESSENGER are 48K Apple II computers 
equipped with a 16K RAM card or the Apple Language System card in 
slot 0. 80 column display cards supported are ALS SMARTERM(tm), 
M&R SUP’R’TERMINAL(tın), and Videx VIDEOTERM(tm). If no 80 column 
card is present, the mail system screen width can be reduced to 
40 columns (see Section 7.5.2 of this manual). 


This document is a combined System Manager’s and User’s guide to 
the MESSENGER, and will assume general knowledge of the 
Cluster/One Model A system and its use in the Pascal 
environment. For more information about the Cluster/One Model A 
network, see the Nestar Cluster/One Model A Network File Server 
User Manual (Publication LC20-0101-0) and the Nestar Cluster/One 
Model A Network File Server System Manager’s Manual (Publication 
LC20-0102-0). 
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Chapter 1 


Introduction 


1.1 What is a Message? 


In the Messenger System, a message is simply a sequence of 
text lines. For example: 


TO: Jones 

FROM: Smith 

DATE: Thu 19-Feb-1981 11:33:10 
SUBJECT : Tomorrow’s meeting 


Please be sure to have the final audit report with 
you so that you can answer any specific questions 
that come up. 


Note that the message contains two parts: the "header" and 
the "body". The header contains special lines that identify 
the sender, receiver, date, and subject of the message. The 
body, which is separated from the header by a blank line, 
consists of any number of lines of text. 


When a message is composed and sent, some of the header 
lines are supplied automatically by the Messenger, while 
others are supplied by the sender. All the header lines are 
displayed when the message is received. Some common header 
lines are: 


TO: Who is receiving the mail directly (always 
present) 

CC: Who else is to receive a copy (optional) 

FROM: Who sent the message (always present- 
automatically generated) 

DATE: When the message was sent (always present- 
automatically generated) 

SUBJECT: A short description of the contents 


(optional) 
IN-REPLY-TO: A reference to a previous message 
(optional) 


The header lines TO, FROM, and DATE are present in all 
messages. 


1.2 The Progress of a Message 


Messages can go through several stages between their 
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creation by a sender and their final disposition by a 
recipient. The three fundamental stages are: 


l. 


The message is composed. For short messages, the 
sender may simply type in the text at the keyboard. 
Previously prepared text can be included at any 
point. 


The message is sent to one or more recipients. These 
can be direct recipients (those on the TO list), or 
people receiving copies (those on the CC list). The 
sender may, if desired, retain a copy of the 
message. The recipients, of course, need not be 
using the Messenger at the time the message is sent; 
mail will be held awaiting delivery for as long as 
necessary. 


The message is received. Delivery of a message is 
completed when a recipient asks to read his incoming 
mail. After a message is read, it can be discarded 
or saved for future reference. If a reply is 
appropriate, a message can be sent back to the 
originator. 


These are the basic stages in the life of a simple message. 
More complex operations are possible, such as forwarding 
mail to others, or requesting return receipts when mail is 
read, but these are just elaborations of the simple scheme. 


Messages reside in one of three places: 


l. 


24 


At the user station, as an "active" message that is 
currently being composed or read. 


On disk, stored and awaiting delivery. Every user of 
the mail system has a queue of incoming messages 
that have not yet been read; this is the "new mail" 
queue, which may be thought of as an electronic 
In-basket. 


On disk, filed away for future reference by the 
sender or the recipient, or both. Every user of the 
mail system has an area on the disk for saving 
copies of mail sent to others and mail received; 
this is the "mail file", which may be thought of as 
an electronic filing cabinet. 


In addition, messages can be printed locally (on a printer 
attached to the user's Apple) or on the network printer, and 
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can be transferred to and from standard Pascal text files. 
(Files used by the Messenger are discussed in detail in 
Chapter 7.) 


The "mail file" can be thought of as a repository of 
messages that have been sent or received. New pieces of mail 
may be entered into this repository at any time and may be 
cross-indexed in categories (called classes) that the user 
invents. These classes can then be used to manage groups of 
messages. 


1.4 Using The Messenger: An Example 





Using the Messenger is extremely simple and does not require 
extensive training or a knowledge of programming. The 
following example demonstrates two basic operations: 


l. Reading an incoming message. 


2. Composing and sending an answer to that 
message. 


In the example that follows, the user’s input is underlined; 
everything else is typed automatically by the Messenger. 
<RETURN> indicates that the return key has been pressed. 
Editorial commentary is enclosed in [brackets]. 


This example assumes that the users of the mail system have 
been enrolled in accordance with the suggestions given in 
the System Manager’s section of this manual (Chapter 7). The 
example also assumes that the Apple Pascal operating systein 
has already been loaded. The Messenger startup is discussed 
in Section 2.1. 


When the Messenger becomes active, it displays a greeting 
such as: 


WELCOME TO THE MESSENGER, VERSION 2.0 
Today is Thu 19-Feb-1981 13:33:13 

For help type ? RETURN to any request 

Command? READ «RET URN? 


[With the READ command the user asks to read 
any mail currently in the new mail queue - 
his In-basket.] 


You have l message: 


02/19 12:54 SMITH 
Read 02/19 12:54 SMITH (Y/N)? Y «RETURN» 
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[Only one new message has arrived since this 
user last read his mail. The timestamp and 
name in the label are used by the system to 
identify the message. By replying "Y" to the 
Messengers prompt the user has asked to read 
the message. ] 


To: JONES 

From: SMITH 

Date: Thu 19-Feb-1981 12:54:14 
Subject : Tomorrow’s meeting 
Display it (Y/N)? Y <RETURN> 


[The header of the message has been displayed, 
and the user, Jones, can decide whether or 
not to look at the message itself. Since 
Jones has replied “Y”, the Messenger 
displays the body of the message.] 


Please be sure to have the final audit report with you 
so that you can answer any specific questions that come 
upe 


IN:A(nswer) D(isplay) F(ile) FO(rward) 
K(eep) N(ext) P(rint) Q(uit) W(rite)? A XRET URN? 


[The body of the message has been listed, 

followed by a menu of actions appropriate for 
incoming messages (the "Incoming" menu, 
appearing here as it does on a 40 column 
Screen). After reading the message, Jones 
has decided to send back an answer, and so 
has typed "A".] 


To: SMITH? <RET URN» 

CC: ? «RETURN? 

Subject: Re: Tomorrow's meeting ? «RETURN» 
Enter message or Zfilename, 

terminate with <CTRL-D> «RETURN» 


[The mail system automatically suggests values 
for the header fields, and by pressing the 
return key, JONES indicates that the 
suggestions are acceptable. He now enters his 
reply to Smith.] 


bring it to the meeting. If not, we may have to stall 


them another day or so. <CTRL-D> «RETURN» 





[In order to signal the end of the message, 
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JONES types a <CTRL-D> (holds down the "CTRL" 
key and presses "D") followed by a return. 
In typing the message, any mistakes can be 
corrected by using the left-arrow, backspace, 
or delete key, depending upon the 
configuration of user's terminal.] 


OUT :D(isplay) F(ile) P(rint) Q(uit) 
R(eceipt) S(end) W(rite)? S <RET URN> 


[Another option list, appropriate for outgoing 
messages, is displayed after the reply has 
been composed (the "Outgoing" menu). Jones 
chooses "S" in order to send his reply.] 


Smith: Writing... Sent. 


OUT :D(isplay) F(ile) P(rint) Q(uit) 
R(eceipt) S(end) W(rite)? Q <RET URN> 


[The reply has been sent and is now in Smith's 
new mail queue, and he will get it when he 
next reads his mail. Since Jones doesn’t want 
to do anything more with the reply he has 
just sent (like saving a copy for himself), 
he answers "Q" for quit and returns to 
reading the mail.] 


IN:A(nswer) D(isplay) F(ile) FO(rward) 
K(eep) N(ext) P(rint) Q(uit) W(rite)? Q <RET URN> 


[the Messenger has returned to the menu that 
asks Jones what he wants to do with the 
incoming message. Since he doesn’t want to do 
anything more with it (like forwarding it to 
someone else), he again reponds with "Q".] 


Command? 


The mail system is now waiting for more commands. Jones has 
received a message, read it, and composed and sent a 
response. 


There are many other commands and features of the Messenger. 


They will be described in the following sections, but they 
all follow the simple menu style of this example. 
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Chapter 2 


Using The Messenger 


2.1 Getting Started 


2.1.1 Automatic Startup and Read 
The Messenger may be configured by the System Manager so 
that the system starts up automatically when the power is 
turned on at a user station. Additionally, the Messenger can 
be made to execute commands automatically at power on: 


WELCOME TO THE MESSENGER, Version 2.0 
Today is Thu 19-Feb-1981 13:33:13 
For help type ? RETURN to any request 


Command? READ «RETURN» 


Here, a greeting appears and the Messenger looks for new 
mail for the station's user as soon as the system is turned 
on. The details of startup and automatic execution of 
commands are given in Chapter 7. 


2.1.2 Executing the Messenger 


If automatic startup is not implemented for a user's 
station, he must boot Pascal and reach the Messenger by 
X(ecute)ing Pascal:Mail from the Pascal command line. If 
the Apple Pascal Operating System is not running at the user 
station, it must be loaded. 


In the case of this "manual" startup, the Messenger’s 
greeting banner will be displayed and a question will 
appear: 

Who are You? 
The user will respond with the identification assigned to 
him by the System Manager (last name or initials, for 
example), and the Messenger will ask 

Command ? 
The Mail System is now operational. 
The Messenger supports the ALS, M&R, and Videx 80 column 
display cards. If no such card is present, message width on 


the display screen can be set to 40 columns (see Section 
7.5.2 for details on customizing the Messenger at your user 
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station). 


2.2 The Messenger’s Three Levels 





The Messengers commands and menu items can be divided into 
four categories and can be entered at three different levels 
(See Table 1, page 2-4): 


l. the "Command" Level (C Level). 
2. the "Incoming Mail" Level (I Level) 
3. the "Outgoing Mail" Level (0 Level) 


Levels I and O each present the user with a menu of further 
actions after a message has been read or composed. For 
instance, if a user types READ at the outermost (Command) 
level of the Messenger, and reads a new message, the 
Incoming Mail menu of further options is then presented, so 
that the message can be filed, answered, printed out, or 
otherwise manipulated by the user. These actions occur at 
the Incoming Mail Level, and the menu options presented 
there are for that message alone. 


Table 1 lists the commands and menu items available at each 
level. The command "READ" moves the user from Level C to 
Level I. The commands "SEND", "ANSWER", and "FORWARD" move 
the user from Levels C or I to Level O (Figure l, page 
2-3). 


At Level C, the Messenger prompts for a command with 
Command? 


On Levels I and O, available commands are displayed in menu 
form. The Level I Incoming menu appears as 


In:A(nswer) D(isplay) F(ile) FO(rward) 
K(eep) N(ext) P(rint) Q(uit) W(rite)? 


on the 40 column screen. On the 80 column screen, the menu 
is displayed on a single line. At Level O, the Messenger 
presents the "Outgoing" menu of commands: 


Out:D(isplay) F(ile) P(rint) Q(uit) 
R(eceipt) S(end) W(rite)? 


The Incoming and Outgoing menus are for use only with the 
current message being read, answered, or forwarded, or to 
ask for the next piece of new mail. Typing Q<RETURN> returns 
the user to the previous level. 


For example, at level C, the Command Level, no activity is 
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pending in the Messenger and the system prompts 
Command? 


Suppose that the user first asks to read new mail (READ) and 
finds five messages waiting in a queue for him. He reads the 
first message (at level I) and decides to ANSWER it (see 
Figure 2, page 2-5). He composes and SENDs his reply at 
Level O, FILEs a copy away, but then decides to delete some 
mail previously filed and rearrange the remaining filed 
messages before continuing to read his new mail. The DELETE 
command is a first level command. The user must type Q 
<RETURN> twice, returning to Level C through the Incoming 
READ level, before entering DELETE. 











/ 
Pascal Command 
Level 


X(ecute) Pascal 


Pascal 


Messenger 






Messenger : 
COMMAND LEVEL | $ 

E e, 
(level C) O 









INCOMING MENU 
(level |) 










OUTGOING MENU 
(level O) 












Fig 1 
Command Level——————— Command ? ———————_- DELETE 
READ f oum b 
INCOMING MAIL MENU—— — —— — Jj. 





A(NSWER) QUIT) 








OUTGOING MAIL MENU 
Fig 2 
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Command Level Section Description 
or Menu Item 





Sending and Receiving 





READ C Jel Read new mail 
N(ext) I Sell Read next piece of mail 
K(eep) T 3,162 Keep a message in the In-basket 
CHECK C 342 Wait for new mail 
SEND, C 3.3 Send messages 

S(end) 0 353.42 Transmit newly composed message 
R(eceipt) 0 3.3.1 Request receipt before delivery 
Filing 

F(ile) I,0 4.2 File new mail 

CLASSIFY C 4.3 Index messages in mail file 
DECLASSIFY C 4.5 Remove message from class 
RENAME C 4.6 Change name of mail-file class 
SHOW CLASSES C,I,0 4.7 Display the current classes 
DELETE C 4.8 Delete messages from mail file 
UNDELETE € 4.9 Recover deleted messages 





Using Filed Mail 








DISPLAY, C 5.1 Display filed mail 
D(isplay) 1,0 3351 Display current message 

HEADERS C 542 Display filed-mail headers 

ANSWER, C 5.3 Answer a filed message 
A(nswer) I 3.3.1 Answer current message 
FORWARD, C 5.4 Forward a new or filed message 
F(orward) I 3.3.1 Forward current message 

RESEND C 5.5 Send a filed message 

WRITE, C 5.6 Write filed mail to Pascal file 

or print on local printer 

W(rite) I,0 3.35.1 Write current mail 

PRINT, C 5.7 Print message on system printer 
P(rint) 1,0 3.3.1 Print current message 

Other 

CLEAR C 6.2 Clear the screen 

HELP C 6.3 Display a command summary 

mo C,1,0 6.4 Prompt for expected action 

NEWS C 6.5 Display news about the system 
INFO C 6.6 Display local information 

NFS C 6.7 Issue NFS commands 

SHOW C 6.8 Display misc. information 
QCUIT) CLO 6.9 Return to previous level 

C = Command Level I = Incoming Mail O = Outgoing Mail 

Table 1 
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2.3 General Rules 





There 


are certain general rules that apply to all 


communication with the Messenger: 
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Le 


All input can be in upper or lower case. 


All input (with two exceptions noted later) is 
terminated by pressing the <RETURN> key. Before the 
return key has been pressed, errors may be corrected 
and replacements typed using the left arrow, 
backspace, or delete key, depending upon the 
configuration of the terminal. 


To leave the current level in the Messenger press Q 
<RETURN>. Q<RETURN> is equivalent to a command to 
"return to what was being done before". 


If the user is unsure about how to repond to any 
prompt, typing ?<RETURN> causes a reminder to be 
diplayed. The reminder describes what the Messenger 
expects next from the user. (Further information is 
available with the HELP command.) 


If any part of a command is left out, the Messenger 
will ask for it. Thus, if a user can’t remember what 
information should be supplied with a particular 
command, typing in the command name alone will produce 
a prompt. 


Prompts that end in "(Y/N) ?" require a yes/no 
response; type either "Y" or "N" (or "y" or "n"), 


followed by <RETURN>. 


To abort any activity, type <ESC><RETURN>. If a menu 
is being displayed, this action will return the user 
to the previous level. if a menu item has been 
selected and input is being prompted for, this action 
will return the user to the menu. 


At the Command level, commands may be abbreviated by 
the first three or more letters (REA for READ, for 
example). However, all letters typed must be in the 
correct order. For example, DELETE can be abbreviated 
DELE, but not DELI. 


(This is the first exception to rule 2.) To stop a 
display from scrolling off the top of the screen, type 
<CTRL-S> (hold down the CTRL key and press S). 
Pressing «RETURN? is not necessary. Type <CTRL-S> 
again to continue the display. (The Messenger 
displays new messages one page at a time, so that 
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10. 


using CTRL-S is not necessary. At the end of each 
page, the Messenger asks MORE (Y/N)? and the user can 
continue to read the message or go on to something 
else.) 


(This is the second exception to rule 2.) To cancel a 
display or other operation in progress, and go on to 
something else, type <CTRL-C> (hold down the CTRL key 
and press C). Pressing <RETURN> is not necessary. 


These general rules apply to all input to the Messenger. 
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Chapter 3 


Sending and Receiving Mail 


Command Level Section Description 
or Menu Item 





READ C 3.1 Read new mail 

N(ext) I 3elel Read the next piece of mail 

K(eep) I 3.1.2 Save new mail without reading 

CHECK C 3.2 Wait for new mail 

SEND, C 3.3 Send mail 

S(end) O 3.3.2 Transmit.a newly composed message 

R(eceipt) O 3.3.1 Request a receipt before mail 

delivery 


Command Level 
Incoming Mail Menu 
= Outgoing Mail Menu 


Ono 
u 





3.1 The READ Command 


The READ command is entered at the Command level and is used 
to ask the Messenger to look for incoming messages in the 
new mail queue. The Messenger will respond to READ with 


You have no new mail 
or with the identification names of any new messages: 


You have 3 messages: 

02/19 14:24 SMITH 

02/19 14:30 JONES 

02/19 15:03 BROWN 

Read 02/19 14:24 SMITH (Y/N)? 


The Messenger asks whether new mail should be displayed, 
listing the messages one at a time. 


The messages are presented in chronological order -- the 
order in which they were generated. The message 
identification includes the month, day, hour and minute at 
which the messages were created, and sender identification. 


Pressing "N" <RETURN>, will cause the Messenger to go on to 


the next message. Messages that are not read will remain in 
the new mail queue for next time. 


9/1/81 Page 3-1 


SENDING AND RECEIVING 


Responding with "Y" «RETURN? will cause the message to be 
read from the new mail queue. The header of the message 
will be displayed, and the Messenger will ask whether or not 
to display the body of the message: 


TO: JONES, BROWN 

FROM: SMITH 

DATE: Thu 19-Feb-1981 14:24:29 

SUBJECT: Upcoming Audit 

IN-REPLY-TO: Message of Thu 19-Feb-1981 13:46:15 
Display it (Y/N)? Y 


This message was sent by Smith to Jones and Brown on 
February 19, in response to a previous message sent the same 
day. The Messenger asks whether to display the body of the 
message. Smith types in "Y" and the message appears. 


The 1980 information is ready for your use. 


Next, whether the body of the message has been displayed or 
not, a menu of choices is presented called the "Incoming" 
menu. This menu is used to determine the disposition of the 
message. 


3.1.1 The Incoming Mail Menu 


After a message has been READ, a menu of options is 
displayed 


IN:A(nswer) D(isplay) F(ile) FO(rward) 
K(eep) N(ext) P(rint) Q(uit) W(rite)? 


To choose a menu item, type the capitalized letters (not 
those in parentheses), followed by «RETURN». Q(uit) returns 
the user to the Messenger Command level. A(nswer) and 
FO(rward) move the user to the Outgoing Menu (the Messenger 
Level 0). 


A(nswer) composes an answer to this message. This menu 
item temporarily suspends examination of new mail, 
and allows the user to compose and send a reply. 
See the ANSWER command (Section 5.3) for an 
explanation of the A(nswer) prompts. When the 
A(nswer) process is finished, the Incoming Mail 
(Level I) menu will be redisplayed so that further 
action can be taken on the same incoming message. 


D(isplay) displays the message again (header and body) 
and then repeats the Incoming menu. 
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F(ile) saves a copy of the message in the user's mail 
file. The Messenger asks whether to file the 
message in one or more particular classes; respond 
with one or more class names (separated by commas), 
or with <RETURN>, to file the message without 
classifying it. 


Classes? MEETINGS <RET URN> 
Filed message number 37 


Filing and classifying mail is discussed in detail 
in Chapter 4. When the message has been filed, the 
Messenger returns to the new mail (Incoming) menu. 


FO(rward) forwards this message to someone else. This 
command temporarily suspends examination of 
incoming mail, and allows the reader to send a copy 
of this message to one or more people, preceded by 
an optional preface that the reader composes. See 
the FORWARD command (Section 5.4) for an 
explanation of the FO(rward) prompts. After the 
message has been forwarded, the new mail menu will 
be redisplayed for other action on the same 

| incoming message. 


K(eep) keeps the message in the new mail queue. 
Incoming mail that has been read (whether or not 
the body was displayed) is normally removed from 
the new mail queue. To keep the message in the 
queue, choose the K(eep) option of the menu and the 
message will be presented again the next time the 
READ command is used. 


N(ext) goes on to the next message. Use this menu 
option after the current message has been 
processed. The current message will be removed from 
the new mail queue unless the K(eep) option was 
selected before N(ext). 


P(rint) For networks with a print server, the Print 
menu item will cause the current message to be 
printed out. Printed format is the same as screen 
display format. 


QCuit) stops processing incoming mail. The current 
message is deleted from the new mail queue unless 
K(eep) was selected before Q(uit). All subsequent 
messages in the queue will remain there until the 
next time the READ command is used. 


W(rite) writes the incoming message to a Pascal text 
file or local printer. The Messenger will ask for 
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the name of a Pascal file to create and write the 
message to. The header and body are written in the 
same format as is displayed on the screen. Using 
Pascal files is discussed in Section 3.4. When the 
message has been written, the new mail menu will be 
redisplayed. Anything already in the Pascal file is 
erased. 


If the file is to be written to a local printer 
(Printer: ), the user station must have a printer 
controller card in slot 1 and the printer must be 
supported by the Pascal operating system. 


NOTE: <ESC> «RETURN» - Exiting from the new mail menu by 
using the escape key causes the current message (and all 
subsequent messages) to be left in the new mail queue, and 
the user to be returned to the command level. 


The Incoming mail menu will be displayed until the user 
selects Q(uit), A(nswer), F(orward), or N(ext) and is moved 
to another level. At the end of the new mail queue, the 
Messenger will display 


End of new mail. 


and return to the command level. If new mail arrives after 
the READ command is given, the Messenger will display 


New Mail has arrived 


and list the new uessages. 


3.1.2 The K(eep) Menu Item 


This is an incoming menu item. If a user responds to the 
prompt 


You have l message: 
07/13 11:00 SMITH 
Read 07/13 11:00 SMITH (Y/N)? 


with "N" <Return>, the piece of mail will be kept in the new 
mail queue. A "Y" reply will cause the header of the 
message to be displayed, together with a second prompt: 


TO: JONES 
CC: BROWN 
FROM: SMITH 


DATE: Mon 13-Jul-1981 11:00:46 
SUBJECT : Missing Audits 
IN-REPLY-TO: Message of Mon 13-Jul-1981 10:58:16 
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Display it (Y/N)? 


Typing "Y" displays the body of the message. Typing "N" 
displays the Incoming menu. Then, pressing "K" <Return> for 
K(eep) will cause the Messenger to keep the message in the 
new mail queue, just as if the header had never been 
displayed. The Incoming menu will then be redisplayed. 


3.1.3 Reading Registered (Return Receipt) Mail 





The sender of a message can request that "return receipts" 
be sent when the message is read by each of the recipients. 
A return receipt is a small message that documents the date 
and time that the original message was accepted. Registered 
mail can also be refused, in which case the return receipt 
indicates refusal, and the recipient is not shown the 
original message. 


When a registered message is delivered, the header is 
displayed and the recipient is asked, 


OK to send return receipt (Y/N) ? 


Answering "Y' causes a return receipt to be sent to the 
originator and the recipient may proceed to display the 
message. An "N" causes the Messenger to ask 


Reject this mail (Y/N) ? 


If "Y", a rejection message is sent to the originator 
indicating that the recipient has chosen not to read the 
mail. The Messenger then continues with the next message in 
the new mail queue. 


"N" to both questions (neither accepting nor rejecting the 
message) causes the message to be left in the new mail queue 
and the same questions will be asked the next time the READ 
command is used. 


To send a registered message, press "R" for Receipt when the 
Outgoing Mail menu is displayed, after the message has been 


composed but before it has been sent. The Messenger will 
respond with 


A return receipt will be requested. 


The CHECK Command 


The CHECK command is very much like the READ command in that 
it looks at the new mail queue and allows incoming messages 
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to be read. It differs from the READ command in the 
following ways: 


l. If the new mail queue is empty, CHECK displays: 
Waiting for new mail. Press space to enter commands. 


and the time. The Messenger then waits for new messages 
to be received. When a message arrives, the computer 
bell rings and the Messenger displays the message 
identification just as if the READ command had been 
used. 


2. After all the new mail has been read, the Messenger 
returns to wait for more new mail, instead of going to 
the command level. 


To return to the command level from Check mode, type a 
space. The prompt 


Command? 


will appear. 


3.3 The SEND Command 


The SEND command is used to compose and send messages. To 
use it, type SEND <RETURN> at the outer level, as in 


Command? SEND <RET URN> 


The Messenger will first ask a series of questions to obtain 
the information to be displayed in the header of the 
message, and then will ask for the text that will form the 
body of the message. 


l. Who is to receive the message: To? 


Respond with the identification of the direct 
recipients of the message. If there are more than one, 
separate them with commas. The identifications depend 
upon how the Messenger is installed by the System 
Manager; they are often the last names or the initials 
of the users. 


To? SMITHE,JONES 


If an incorrect identifier is typed in response to the 
prompt To?, the Messenger will later display 


SMITHE : No such user 
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when the S(end) option is used. In this example, Jones 
has entered Smith’s name incorrectly in response to the 
To:? prompt. 


2. Who is to receive copies of the message: CC? 


Respond with the identification of people who are to 
receive copies of the message. The same rules as for 
specifying people on the "TO" list apply here. The 
Messenger makes no distinction between people on the 
"TO" list and those on the "cc" list. The only 
difference is in the interpretation applied by the 
recipients; in some organizations the protocol may be 
that those on the TO list are expected to reply or take 
specific action, but those on the CC list are being 
sent copies for their information only. 


Note: To have no one on the CC list, press <RETURN> in 
response to the prompt. 


3. What is the subject: Subject? 


Respond with a short description (on a single line) of 
the message. To supply no subject, press <RETURN>. 


All the information necessary for the header has now been 
given. The date, time, and sender’s identification are 
supplied automatically. The Messenger next asks for the body 
of the message: 


Enter message or %filename; terminate with 
<CTRL-D><RET URN> 


Type in the text of the message. (Header and body entries 
can include text copied from Pascal files; file names to be 
copied are preceded by "4". A discussion of this subject is 
found in Section 3.4, "Using Pascal Files".) Terminate each 
line with <RETURN>.+ 


When the body of the message has been completed, type 
<CTRL-D> <RETURN>, either on a line by itself or at the end 
of the last line of the message. (<CTRL-D> is typed by 
holding down the "CTRL" key and pressing the "D" key.) 


The message is now completely assembled, and the Messenger 


presents a menu of choices, called the "outgoing mail menu", 
which can be used to determine what is to be done with it. 
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3.3.1 


Page 


The Outgoing Mail Menu 


Out: D(isplay) F(ile) P(rint) Q(uit) 
R(eceipt) S(end) W(rite)? 


To choose a menu item (as with all menus presented by the 
Messenger), type the capitalized part of the name and press 
<RETURN>. For example, to D(isplay) the message, type 
"D<RET URN>". 


D(isplay) displays the entire message that has been 
composed. Both the header and the body are 
displayed. 


F(ile) This menu item saves a copy of the message in 
the sender’s mail file. The Messenger will ask for 
an optional list of classes; respond with one or 
more class names separated by commas, or with 
<RETURN> to file a copy without assigning a class. 


Classes? <RETURN> 
Filed message number 38 


The outgoing mail menu will be redisplayed for 
further action. 


Q(uit) stops the processing of this outgoing message. 
All action that you have previously specified will 
take place, but nothing else. If you have not 
F(iled), S(ent), P(rinted), or W(ritten) a copy of 
the message, you will be reminded that upon 
exiting, the message will be lost: 


OK to discard message (Y/N)? 


P(rint) For networks with a Nestar A-2803 print 
server, the Print menu item causes the current 
message to be printed out. Printed format is the 
same as screen display format. 


R(eceipt) This requests that a "return receipt" be 
sent to you when the message is read by each 
recipient. The return receipt is a message that 
indicates whether the message was refused or 
accepted, and at what time. This option, if it is 
used, must be specified before S(end). Receiving 
"registered" mail is described in Section 3.1.3. 


S(end) This sends the message to all people in the TO 
and CC lists of the message. As the message is sent 
to each person, the identification is displayed. If 
the message is being sent to a long list of people, 
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using <CTRL-C> (holding down "CTRL" and pressing 
"C") will stop the transmissions, but any copies 
already sent cannot be rescinded. 


W(rite) writes a copy of the outgoing message to a 
Pascal text file or local printer. The Messenger 
will ask for the name of a Pascal text file to 
create and write the message to. After the message 
has been written, the outgoing mail menu will be 
redisplayed. If the Pascal file already exists, you 
will be asked for permission to overwrite it. 


If the file is to be written to a local printer 
(Printer: ), the user station must have a printer 
controller card in slot 1 and the printer must be 
supported by the Pascal operating system. 


<ESC> <RETURN> Exiting from the outgoing mail menu by 
using the escape key is the same as typing Q(uit). 
If you have not F(iled), S(ent), P(rinted), or 
W(ritten) a copy of the message, you will be 
reminded that upon exiting the message will be 
lost: 


OK to discard message (Y/N)? 


The outgoing mail menu will continue to be displayed until 
the Q(uit) option or <ESC> <RETURN> are used to return to 
the Command or Incoming Mail level. 


3.3.2 The S(end) Menu Item 


The S(end) outgoing menu item is executed by pressing "S" 
<Return> when the Outgoing menu is presented. S(end) 
causes the Messenger to deliver the message that has just 
been composed. 


If Send is not used, the newly composed message will not be 
sent. Note that by composing but not sending messages, the 
user can use the Messenger to write notes or messages to be 
filed (using the File menu item) in one’s own mail file 
under some convenient class name. 


To compose a message and send it at a later date, use the 
RESEND command (Section 5.5). 


Having composed and sent a message using S(end), the user 
will often want to compose and send another. To do so, press 
Q(uit) to return to the Command level, and type SEND again 
to repeat the process. Typing S(end) again without 
returning to the Command level will cause the Messenger to 


9/1/81 Page 3-9 


SENDING AND RECEIVING 


display 
Already sent. Send again? (Y/N)? 


for each recipient in the TO: list. This is to remind the 
user that in order to compose a new message, "SEND" must be 
typed in at the Command level. 


3.4 Using Pascal Files 


Pascal text files can be included in message headers and 
bodies by specifying the filename, preceded by "%", in 
response to the Messenger’s prompts. 


For example, the prompt and response 
To? ¿STAFF 


will cause the Messenger to send the message being composed 
to the mailing list found in the file STAFF. This option is 
especially useful when messages are frequently sent to a 
long list of recipients. Recipients should be listed in the 
file just as they would be in the To: and CC: headers. (For 
readibility, carriage returns may be used between names in 
the file.) Names that are not part of. the file may be 
included either before or after specifying the file. For 
example, 


To?  ZTECHSTAFF JONES , SMITHE 


For detailed rules about the construction of Pascal file 
names, see Appendix B. 


If a file with text other than a list of recipient 
identifications is used for a message header, or if 
recipients are not identified properly in the specified 
file, the Messenger will display 


SMITHE: No such user 
when the S(end) option is used. 
Text from Pascal files may be inserted into the body of a 
message in any order. To include a previously prepared text 
file at any point, type 

filename «RET URN»? 
on a separate line at the place where the file is to be 


inserted. Note that Z must be placed in the first space of 
the line; otherwise it is treated like any other character. 
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The Messenger will display the contents of the file as it is 
being used. Include as many files as desired, interspersed 
in any fashion with text entered from the keyboard. 


In the case of multiple insertions of large files, all 
available space in the local Apple memory may be used up. 
The message 


***MEMORY OVERFLOW*** 


will then be displayed. The part of the message that fit 
into memory can be sent, together with a few more lines of 
text, by accepting it with Ctrl-D and using S(end). To 
start over, use Ctrl D, Q(uit), and type SEND again from the 
Command level. 
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Chapter 4 
oj Filing Mail 
Command Level Section Description 


or Menu Item 





F(ile) 1,0 4.2 File new mail 

CLASSIFY C 4.3 Classify messages in one or more 
classes in mail file 

DECLASSIFY C 4.5 Remove message from classes in 
mail file 

RENAME C 4.6 Change the name of a mail-file 
class 

SHOW CLASSES C,I,0 4.7 Display the current classes 

DELETE C 4.8 Delete messages from mail file 

UNDELETE C 4.9 Recover messages accidentally 
deleted 

Level C = Command Level 


Level I = Incoming Mail Menu 
Level O = Outgoing Mail Menu 





Filing Commands 


The Messenger’s filing system is simple to use. No special 
programming knowledge is necessary. Prompts are provided for 
the user by the system. Remember, however, that not all 
commands and menu items are available at all levels of the 
system. For instance, the F(ile) menu item is only available 
at the incoming and outgoing message levels, for use with 
the message currently being read, sent, answered, or 
forwarded. In the list of commands and menu items above, 
five (CLASSIFY, DECLASSIFY, RENAME, DELETE, and UNDELETE) 
are available only at the Command level, and can not be used 
when the incoming or outgoing menus are being displayed. 


4.2 The F(ile) Menu Item 


The F(ile) menu item saves a copy of the message that is 
currently being read, sent, answered, or forwarded, storing 
it in the user’s mail file (as if it were an electronic 
filing cabinet). This file can be cross-indexed with as 
many as 24 subjects or categories (called "classes"). A 
message can be cross-indexed in any or all classes. Commands 
for naming and renaming classes, and classifying and 
declassifying the messages stored in them, are discussed in 
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Sections 4.3 through 4.6. 


A mail class is simply a name chosen by the user to 
characterize a set of messages; the class name can be used 
in commands to the mail system. 24 classes are allowed by 
the Messenger, and each filed message can belong to any of 
them. In addition to any class names given to it, each filed 
message also has a message number that can be used to 
reference it. 


A new class name is created when the first message is put 
into that class. When a message is displayed, its message 
number and the classes to which it belongs are also 
displayed. 


When the F(ile) option is selected from the Incoming or 
Outgoing menu, the Messenger asks 


Class? 


Respond with one or more class names (separated by commas) 
to file the message under specific class names, or with 
<RETURN> to file the message in no class. 


For example, at the Outgoing level, a message is composed 
and the Outgoing menu is displayed: 


Out :D(isplay) F(ile) P(rint) Q(uit) 
R(eceipt) S(end) W(rite)? F «RETURN? 


Class? MEETINGS, CUSTOMERS «RETURN» 
Filed message number 37 


In this example, the user, having composed a message, files 
it in two classes, MEETINGS and CUSTOMERS. As discussed in 
the following sections, class names and message numbers are 
used to identify messages to be stored, displayed, and sent. 
Responding to the "Class?" prompt above with «RETURN? would 
have caused the Messenger to file the message being sent 
without assigning it to any class. 


After filing the message, the Messenger redisplays the 
Incoming or Outgoing menu for further action at the current 
level. 


If the mail file is full and no more messages can be filed 
in it, the Messenger will display, for example, 


Not enough free blocks; need 9, have 3 


(A block holds about 500 characters.) To save the current 
message when this occurs, use the Incoming menu’s K(eep) 
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option to retain the message in the new mail queue; then 
make more room in the mail file by DELETING some messages 
from the mail file. (To save messages before deleting them, 
P(rint) them or W(rite) them to a Pascal file first.) 
Execute READ to return to the new mail queue and F(ile) the 
message waiting there. (DELETE and WRITE are discussed in 
Sections 4.8 and 5.6.) 


The CLASSIFY Command 


The CLASSIFY command allows the user to add new 
classifications to one or more messages saved in the mail 
file. The syntax is 


CLASSIFY <messages>,<classes> 


where <messages> describes which messages are to have 
classes added, and <classes> is a list of one or more class 
names. For example, 


CLASSIFY 33 
Class? COMPETITORS, SALES 


(This example shows how information not supplied is asked 
for.) 


If, as in this example, the Messenger asks for the class 
name, the user can name a class or classes, or respond with 
"SHOW CLASSES" to have the current list of known classes 
displayed. The "Class?" question will then be asked again. 
Pressing <RETURN> or <ESC><RETURN> returns the user to the 
Command? prompt. 


When a class name is used that has never been used before, 
the Messenger prompts 


No class xxx exists. 
Create it (Y/N) ? 


For "Y", the class name is entered into the class table and 
assigned to the messages; for "N", the class is not 
created. 


If 24 classes already exist, the Messenger will display the 
message 


Too many classes 
If this happens, the current message can be filed 


temporarily without a class. Before it can be placed in a 
new class using CLASSIFY, one or more existing classes must 
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4.4 


be removed using the RENAME command (Section 4.6) at the 
outer Command level. 


Using the CLASSIFY command to place a message in new classes 
does not create extra copies of the message with new message 
numbers; the single copy is simply recorded as a member of 
additional classes, 


As explained in the previous section, this same sequence may 
be used when classes are being assigned to mail that is 
filed using the F(ile) option of the Incoming and Outgoing 
menus. 


Many of the Messenger commands operate on one or more 
messages in the mail file. There are many ways:to specify 
which messages are to be affected by a command; a complete 
formal description is given in Appendix A. Some of the 
common ways, shown using the DISPLAY command (discussed in 
Section 5.1) are: 


l. A message number. Simply give the number of the 
message. 


Example: DISPLAY 21 
2. A message class. Give the name of a message class 
preceded by "8" (ampersand) or by "GQ" (at-sign). 
All messages which belong to that class will be 
selected. 


Example: DISPLAY &MEETINGS 


3. A range of message numbers. Give the starting and 
ending message numbers separated by ":" (a colon). 


Example: DISPLAY 2:5 

4. All messages in your message file. Just say "ALL". 
Example: DISPLAY ALL 

5. All unclassified messages. Type "&NONE" 
Example: DISPLAY &NONE 

6. The current message. The last message accessed in 


the mail file is refered to as the "current" message 
and can be specified by using "." (period). 
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Example: DISPLAY . 


7. The first, last, next, or previous message. "First" 
and "last" refer to the first message in the mail 
file (message number 1) and the last message in the 
mail file (the highest numbered message). "Next" 
and "previous" refer to the messages before and 
after the current message. 


Examples: DISPLAY F (first message) 
DISPLAY L (last message) 
DISPLAY P (previous message) 
DISPLAY N (next message) 


More complicated expressions can be constructed using these 
basic elements plus some others described in Appendix A. 


Here are some examples and their interpretations: 
DISPLAY L-5 Display the fifth message from the last. 


DISPLAY GNOTES IN 1:10 Display any of the first ten 
messages in the class "NOTES". 


DISPLAY .!5 Display the next five messages. 
In descriptions of the commands, the symbol «messages? is 
used to indicate that some messages from the mail file are 
to be specified. Use any of the ways to describe messages 


in place of the symbol <messages>. For example, the DISPLAY 
command is described as 


DISPLAY <messages>,<classes> 


and any of the examples in this section can be used in place 
of <messages>. 


The DECLASSIFY Command 
The | DECLASSIFY command allows the user to remove 
classifications from one or more messages in the mail file. 
The syntax is: 

DECLASSIFY <messages>,<class> 
where <messages> indicates which messages are to have 


classifications removed, and <class> indicates which 
classification is to be removed. For example 


DECLASSIFY L,SALES 
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will remove the last message in the mail file from the 
"SALES" class. 


If any of the specified messages are not in the named class, 
the prompt 


Message #nn is not in class. 


will appear. If there is no such class name, messenger 
displays 


No such class. 


The RENAME Command 


The RENAME command allows any classification name to be 
changed. The syntax is: 


RENAME <oldname>,<newname> 


where <oldname> is the current name of the classification, 
and <newname> is the new name of the classification. For 
example, 


RENAME DATES, APPOINTMENTS 


This moves all messages in the DATES class to a new class 
named APPOINTMENTS, and the DATES class no longer exists. 
This does not affect any of the other classes that messages 
in DATES might also have been in. 


RENAME can be used to eliminate unwanted classes completely 
(e.g., when 24 classes have been named, and room for new 
class names is needed). For example, 


RENAME DATES, <blank> 


will remove the classification DATES from all messages filed 
in that class. The Messenger will make sure that <newname> 
is not being forgotten by asking "New Class?". Type «RETURN» 
and DATES will be eliminated as a class name. The Messenger 
will display the message number and subject header of each 
message in DATES as it is declassified. 


Typing RENAME <blank>,newname will create an empty class 
named newname. 
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The command SHOW CLASSES lists all the classification names 
that are currently defined. At the Command level, type in 
SHOW CLASSES in response to the prompt "Command?", or to 
"Class?", which appears when the commands CLASSIFY or 
DECLASSIFY are given. At the Incoming or Outgoing menu 
levels, after selecting the F(ile) option, type in SHOW 
CLASSES when the Messenger prompts with "Class?". For 
example, 


Command? classify 5 <Return> 
Class? show classes <Return> 


CONTRACTS DATEBOOK 
AUDITS AJAX FILE 
FISCAL 


5 of 24 classes are named 
Class? Fiscal <Return> 


Here, the user has decided to classify message number 5 in 
the mail file, but wishes to see a listing of current 
classes first. Message 5 is then classified in "Fiscal". 


The same action at the Incoming level: 
In:A(nswer) D(isplay) F(ile) FO(rward) 


K(eep) N(ext) P(rint) Q(uit) W(rite)? F «RETURN? 
Class? show classes «Return» 





CONTRACTS DATEBOOK 
AUDITS AJAX FILE 
FISCAL 


5 of 24 classes are named 
Class? Fiscal «Return» 


Pressing <Return> in response to the prompt "Class?" at the 


Incoming and Outgoing levels will cause the Messenger to 
file message 5 without classifying it. 


4.8 The DELETE command 





The DELETE command is used to remove one or more messages 
from the mail file. The syntax is 


DELETE «messages»? 


where <messages> describes which messages are to be 
deleted. 


DELETE 1:10 
DELETE &NOTES 
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As each message is deleted, its message number will be 
displayed. If, in the example above, a message belongs to 
the class &NOTES and to another class, it will not be 
deleted, but only removed from the class &NOTES. 





WARNING: Message numbers are always consecutive in the 
Messenger. For example, immediately after deleting, for 
example, message number 12, the message whose number was 13 
is now 12, the message whose number was 14 is now 13, etc. 
Take care, in doing a sequence of DELETE commands, that this 
implicit renumbering of the messages does not cause 
accidental deletions of the wrong messages. To delete 
several messages by message number, delete the highest 
numbered messages first. 


4.9 The UNDELETE Command 





The UNDELETE command is a seldom-used command used to 
retrieve filed messages that have been accidentally 
deleted. The syntax is simply 


UNDELETE 


All previously deleted messages that can be recovered will 
be filed at the end of the user’s mail file. If no new 
messages have been filed since the last DELETE command, then 
at least all the messages recently deleted will be 
recovered. It is likely that additional messages deleted 
earlier will also be recovered, in which case it may be 
necessary to display all the recovered messages and delete 
those not wanted. 


Undelete will not retrieve messages that were read but not 
filed. 
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Chapter 5 


Using Filed Mail 


Command Level Section Description 


or Menu Item 
eee 


DISPLAY, C 5.1 Display filed mail 
D(isplay) I,0 Fel el Display current message 
HEADERS C 5.2 Display only the headers of filed 
mail 
ANSWER, C 5.3 Answer a filed message 
A(nswer) I 351. ol Answer current message 
FORWARD, C 5.4 Forward a filed message 
F(orward) I doled Forward current message 
RESEND C 5.5 Send a filed message 
WRITE, C 5.6 Write a filed message to a Pascal 
file or local printer 
W(rite) 1,0 3.141 Write current message to a Pascal 
file or local printer 
PRINT, C 5.7 Print a filed message on system 
printer 
P(rint) I0 3.1.1 Print current message on system 
printer 


Level C = Command Level 

Level I = Incoming Mail Menu 

Level O - Outgoing Mail Menu 
ccu ——————— —"t— 


Un 


el The DISPLAY Command 





The DISPLAY command, when typed in at the Command level, is used 
to display one or more messages (both header and body) that have 
been filed in the user's mail file. When selected from the 
Incoming or Outgoing mail menu, D(isplay) redisplays the message 
that has just been read or composed. At the Command level,- the 
syntax is: 


DISPLAY <messages> 


where <messages> describes which messages are to be displayed. 
For example 


DISPLAY L 
displays the last message (the one most recently filed) in the 


mail file. As discussed in Section 4.4, there are many ways to 
specify which messages are to be affected by a command; a 
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complete formal description is given in Appendix A. The most 
common ways are to give the number of the message, or specify 
"ALL", or give the name of a message class or range of message 
numbers. 


Remember that, as with other commands, there are two ways to 
interrupt the output of the DISPLAY command: 


(1) Temporarily, using <CTRL-S> to stop and again to start. 


(2) Permanently, using <CTRL-C>. The Messenger will display 
'",..ABORTED" and return to the outer command level. 
However, <CTRL-C> is for use with operations in progress 
only, not for static prompts such as "Class?". Also, 
when displaying new messages, the Messenger will stop 
automatically when the screen is full, and ask MORE 
(Y/N)? 


5.2 The HEADERS Command 


The HEADERS command will print a one line summary of one or 
more messages that have been filed in the mail file. The 
command syntax is: 


HEADERS <messages> 


where <messages> describes which messages are to be 
summarized. For example 


HEADERS ALL 
HEADERS output has the format 


#1 <=Smith Tue 19-Feb Tomorrow's meeting [1 
#2 =>Jones Tue 19-Feb Audit for meeting [1] 
#3 =>JDN,SKF,... Wed 20-Feb Audit format 


ee and so on ... 


The number in the first column of this example is the 
message number in the mail file; this number can be used to 
refer to this message as part of the <messages> item in 
other commands. The arrow indicates whether the message was 
to ( => ) or fron ( <= ) the person listed in the next 
column. If the message was sent by the user to other people, 
then the arrow will point to the right 


=> names 


An ellipsis (...) will appear if there are too many names to 
fit in the field. For a message to the user from someone 
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else, the arrow will point left 
<= name 
away from the initials of the sender. 


The next two fields display a partial date and the subject 


of the message. The last field in each header, in 
parentheses, gives a rough idea of the length of the 
message; each increment corresponds to about 500 
characters. 


5.3 The ANSWER Command 


The ANSWER command is a variant of the SEND command, used to 
reply to messages stored in the mail file. ANSWER supplies 
suggestions for some of the header fields, to make it easier 
to compose a response to the filed message. 


To use the ANSWER command, type 
ANSWER <messages> 


where <messages> identifies the message (or messages, 
although there usually will be only one) in the mail file to 
be answered. 


The sequence described here for the ANSWER command can also 
occur by selecting the A(nswer) option of the new mail 
menue In that case the message being answered is the one 
being read. 


Note: The Messenger cannot ANSWER, FORWARD, or RESEND long 
messages, and will display "Memory Overflow" to indicate 
that a message is too long for ANSWER to be used. 


When constructing the header of the message using ANSWER, 
the Messenger will suggest values based on the header lines 
of the message being answered or forwarded. The sender can 
either 
l. accept the suggested value by pressing <RETURN>, or 
2. supply a substitute by typing it followed by 
<RETURN>. To remove the suggestion and leave it 
blank, type a blank followed by <RETURN>. Or 


3. add to the suggested value by typing in 
<,addition><RETURN>. 


If the sender supplies a substitute for the suggested value, 
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the Messenger will again display the information for 
confirmation, this time using the substitute as the 
suggestion. It will continue to prompt with suggested values 
until <RETURN> only is pressed. 


5.3.1 Header Line Suggestions Supplied By ANSWER 


These are the suggestions supplied automatically by the 
Messenger for the header lines of a message that is 
answering an earlier message: 


l. For the "TO" header line, the suggested value is the 
sender of the message being answered. 


2. For the "CC" header line, the suggested value is the 
concatenation of the "TO" and "CC" header lines of 
the message being answered, except that the current 
sender is removed. 


3. For the "SUBJECT" header line, the suggested value 
is the subject of the message being answered, with 
"Re:" before it. 


When the header has been completely constructed, enter the 
body of the message just as for the SEND command. The 
outgoing mail menu, as for the SEND command, is then used to 
control the disposition of the message. 


5.4 The FORWARD Command 
The FORWARD command is a variant of the SEND command. Use it 
to send a message from the mail file to one or more people, 
along with any desired prefatory remarks. 


To use the FORWARD command, type 
FORWARD <messages> 


where <messages> identifies the message (or messages, 
although there usually will be only one) in the mail file to 
be forwarded. 


Note: The sequence described here for the FORWARD command 
can also occur by selecting the FO(rward) option of the 
Incoming mail menu (Section 3.1.1). In that case the 
message being forwarded is the one currently being read. As 
with the ANSWER command, the Messenger cannot FORWARD long 
messages and will display "Memory Overflow" to indicate that 
a message is too long to be forwarded. 
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5.4.1 The FORWARD Header 


When constructing the header of the message using FORWARD, 
the Messenger will, as with ANSWER, suggest values based on 
the header lines of the message being answered or forwarded. 
Either 


l. accept the suggested value, by pressing <RETURN>, or 


2. supply a substitute by typing it followed by 
<RETURN>. To remove the suggestion and leave it 
blank, type a blank followed by <RETURN>. Or 


3. add to the suggested value by typing 
<,addition><RETURN>. 


If a substitute is supplied for the suggested value, the 
Messenger will again ask for the information, this time 
using the replacement as the suggestion. It will continue to 
prompt with suggested values until one is accepted. Again, 
press <RETURN> to do this. The substitute can include 
external files by using the %file notation. 


5.4.2 Header line suggestions for FORWARD 


The Messenger supplies these suggesions for headers of 
forwarded messages. 


l. For the "TO" header line there is no suggested 
value; supply the direct recipients just as for 
SEND. 


2. For the "CC" header line there is no suggested 
value; supply the CC recipients just as for SEND. 


3. For the "SUBJECT" header line, the suggested value 
is the subject of the message being answered, with 
"Re: " before it. 


After the header has been constructed, the Messenger prompts 
for a preface to the message: 


Enter preface or Zfilename, 
terminate with CTRL-D RETURN 


Enter the text of the preface just as for the body of a 
message being composed with SEND. When the preface is 
finished, type <CTRL-D>. The Messenger then will append the 
message being forwarded, surrounded by the lines 
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=== BEGIN FORWARDED MESSAGE --- 
=== END FORWARDED MESSAGE --- 


so that it is clear to the recipients that the message is 
imbedded within another message. 


After the forwarded message has been copied, the standard 
outgoing mail menu is used to control the disposition of the 
entire package, including the new header, preface, and the 
embedded message. 


The RESEND Command 


The RESEND command is used to send messages that have been 
filed in the user’s mail file: 


Command? Resend <Return> 
Message range? 3 <Return> 


The Messenger will prompt for recipient and copies using the 
identifiers in the filed headers. These may be changed by 
the user in the same way as the FORWARD and ANSWER prompts: 


To: Smith? <Return> 

CC: Jones,Brown? <Space><Return> 
CC:? <Return> 

Copying message... 

OUT :D(isplay) F(ile) P(rint) Q(uit) 
R(eceipt) S(end) W(rite)? 


Here, after requesting that filed message #3 be sent, the 
user accepts the To: prompt by pressing <Return>, and 
changes CC: from "Jones,Brown" to "no copies" by pressing 
the space bar and <Return>. The Messenger then prepares the 
message to be sent ("Copying message...") and displays the 
Outgoing mail menu. 


Messages in a class can be sent by entering "&classname" in 
response to the "Message range?" prompt. 


As with the ANSWER and FORWARD commands, the Messenger will 
not RESEND long messages, and will indicate with "Memory 
Overflow" that a message is too long for use with RESEND. 


The WRITE Command 


The WRITE command is used to write one or more messages to a 
Pascal text file or local printer. The syntax is: 
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WRITE <messages> 


where <messages> specifies which messages are to be written. 
The Messenger asks 


To what file? 


Respond with the name of the Pascal text file to be created 
or written into; see Appendix B for information about file 
names. To use a local printer, type "Printer:". Messages to 
be printed can be specified in the same way as messages to 
be displayed or written. A complete description of syntax 
is given in Appendix A. See also Section 4.4. Both the 
header and body of each message are written, and the number 
of the message is displayed on the screen as it is written 
to the file. As with all commands, <CTRL-C> will abort the 
operation. 


WARNING: The write command DOES NOT append messages to a 
file of messages. When a file name is specified and the file 
already exists, everything in it is replaced. However, the 
Messenger will warn that this is about to happen. 


For example, suppose that Mr. Jones decides to store all of 
his correspondence regarding company audits in a Pascal file 
and issues the command 

WRITE SAUDITS 


The Messenger asks, 


To what file? Audits 


# 4: =>SMITH Wed 10-Jun Audit Needs [1] 
# 8: <=SMITH Tues 14-Jul Audit Situation [2] 
ete 


Later in the day Mr. Jones decides to add a new message and 
issues the command 


WRITE 11 
To what file? Audits 


The warning will appear 

OK to overwrite existing AUDITS.TEXT (Y/N)? 
Mr. Jones must write his new message to another file and 
merge the files using the Pascal Filer or Editor. If he 
replies "Y" to the prompt, the messages written earlier will 


be erased. (The subject of Pascal textfile names is 
discussed in Appendix B.) 
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Un 





Using WRITE to the file "PRINTER:" will cause the specified 
message to be printed on a local printer plugged into your 
Apple. The PRINT command described in the following section 
is for use with a printer attached to a print-server Apple. 
For use with the Messenger, local printers must be supported 
by the Pascal operating system and must be controlled by a 
card in slot 1 of the user station Apple. 


The PRINT Command 


The PRINT command can be used at any level of the Messenger 
to print messages on a system printer. PRINT creates 
print-request files that specify which messages are to be 
printed. These request files are read by the Nestar Printer 
Server Program (Product No. A-2803), which causes the 
specified messages to be printed. The Printer Server need 
not be in operation when the print requests are queued. 


Messages to be printed can be specified in the same way as 
messages to be displayed or written. A complete description 
of syntax is given in Appendix A. For example 


Command? Print 
Message Range? 1:2 





# l: «Smith Thu 09-Jul Re:Audit Plans [2] 
# 2: =>Jones Fri 10-Jul Re:Audit Snafu [1] 
Print request queued 

Command ? 


and the Messenger has queued the messages filed #1 and #2. 
At the Incoming or Outgoing menu levels, selecting menu item 
P(RINT) causes the Messenger to queue the message currently 
being read, sent, or otherwise manipulated. 
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Other Commands 


Command Level Section Description 
or Menu Item 








CLEAR C 6.2 Clear the screen 
HELP C 6.3 Display a command summary 
epu GT. 6.4 Prompt for next action 
NEWS C 6.5 Display news about the system 
INFO € 6.6 Displays local information 
NFS C 6.7 Issue Network File Server commands 
SHOW C 6.8 Display miscellaneous information 
QCUIT) Cs 130 6.9 Return to previous level 

Level C = Command Level 

Level I = Incoming Mail Level 

Level O = Outgoing Mail Level 
6.1 Other Commands 





o 
. 
N 





With the exception of Q(uit) and "?", these commands are 
available only at the Command level. 


The CLEAR command 


The CLEAR command clears the display screen. 


The HELP Command 


The HELP command displays one-line summaries of most of the 
commands available at the Command level of the Messenger. 
For example, 


Command? Help 
Commands are: 
ANSWER <msgseq> - Reply to message(s) 
CHECK — Continually check for new incoming mail 
CLASSIFY... eee 


and so on. 
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and 











The "?" Command 

Entered in response to any prompt, "?" causes the Messenger 
to explain what the user is expected to do next. For 
example, 


Command? ?. 
Enter <cmd> [<operand>]] or HELP to list commands 


Command? send 

To: ? ? 

Initials, or %file, or RETURN to accept default 
To:? 





The NEWS command 


The NEWS command displays the contents of a news file. The 
news file is maintained by the System Manager at each 
installation, and can contain information specific to the 
Messenger, or information of a more general nature. 


The INFO Conmand 


The INFO command displays the contents of an information 
file. The information file is maintained by the System 
Manager and can contain anything of interest to the users. 


The NFS command 


The NFS command is used to issue commands to the Network 
File Server. There are two forms: 


NFS <command> This form allows the user to specify a 
single NFS command, The Messenger 
executes the command and returns the 
user to the Command level, 


NFS This form allows the user to enter a 
submode from which to enter repeated NFS 
commands. The Messenger prompts with 


NFS command or Q(uit): 


Enter any NFS command. The command will 
be executed and the prompt repeated. 
Entering "Q" causes the Messenger to 
return to the Command level. 
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One common use of the NFS command is to MOUNT a virtual 
disk, onto which filed messages can be written using the 
WRITE command, and from which Pascal files can be copied 
into headers and messages using the % option. (See Chapter 
7 for a discussion of the Messengers use of virtual 
volumes.) 


The NFS command SET DIR should not be used from the 
Messenger. SET DIR is used by the mail system in reading new 
mail; changing directory default values will prevent the 
system from reading new messages. 


The SHOW Command 


The SHOW command can be used to display various information 
about the messenger and its environment. The syntax is: 


SHOW <option> 
where <option> is one of the folloving: 


CLASSES Display the classifications of mail in the 
mail file. 


VERSION Display the version number of the Messenger 
being used. 


FREE Display the number of free blocks in user's 
mail file. Each free block can store about 500 
characters. 


SPACE Display the amount of free space in the local 
memory of the computer. The free space is in 
"words" and each word can hold 2 characters. 


The QUIT Command or Menu Item 


The QUIT Command, entered as Q at all three levels, returns 
the user to the previous level: 


Typing Q at the Command level cause the user to exit 
from the Messenger. 


Typing Q from the Incoming menu returns the user to the 
Command level. 


Typing Q from the Outgoing menu returns the user to the 
Incoming menu or to the Command level, depending upon 
which command, SEND, ANSWER, or FORWARD, was used to 
reach the Outgoing level. 
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Chapter 7 


System Operation 


This chapter contains information primarily of interest to 
the System Manager or other person responsible for new 
Messenger users. It assumes that the reader is familiar with 
the Nestar Cluster/One Model A system and the Network File 
Server (NFS) program, as described in the Cluster/One User's 
Manual and System Manager's Manuals (Publication Numbers 


LC20-0101-0 and LC20-0102-0). 


Cluster/One Model A systems that use the Messenger may be 
configured with floppy disk and/or hard disk units. Systems 
must support the Pascal operating system at user stations. 
The Messenger requires a Nestar clock/calendar card (Product 
No. A-2401), installed in the file server Apple. If times 
returned by the Messenger are 00.00.00, the clock/calendar 
card is not installed or is not operating correctly. 


The Messenger requires a 64K Apple 11 (48K Apple II with 16K 
RAM card or the Apple Language System card in slot 0) as a 
user station. 30 column display cards supported are ALS 
SMART ERM (tm), MER SUP’R’TERMINAL (tm), and Videx 
VIDEOTERM(tm). If no 80 column card is present, message 
width can be limited to 40 columns (see SET WIDTH in Section 
74552). 


The Messenger Mail System software consists of four Pascal 
files: Mail.Code, MailHelp.Text, MailNews.Text, and 
MailInfo.Text. If the Messenger has been purchased as part 
of the Cluster/One Model A, these files will reside on the 
system distribution disk, with the directory pathname 
/MAIN/PRODUCT/MAIL. Otherwise, they are shipped on a 
distribution 5.25" floppy disk (Pascal volume name MAIL:), 
and can be transferred to the system disk using the Pascal 
Filer’s T(ransfer) function. 


Mail.Code contains the Messenger System software. 
MailHelp.Text contains the list of responses displayed when 
the HELP command is entered. MailNews.Text and Maillnfo.Text 
contain the text displayed in response to the Messenger 
commands NEWS and INFO. The System Manager may use these 
files for company and/or mail system news and information. 
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7.1.1 


7.2.1 


Page 


Recommended Installation Procedure 


Transfer all four files from /MAIN/PRODUCT/MAIL or MAIL: to 
the Pascal library volume /MAIN/PASCAL/LIB. The Messenger 
can then be started from any user station by X(ecuting) 
Pascal :MAIL from the Pascal command line. For automatic 
startup from the user station, see Section 7.5. 


If the system defaults (described in the following sections) 
are acceptable, no further initialization of the Messenger 
is necessary. As each new user uses the Messenger, files 
necessary for operation of the system will be created 
automatically. 


The Messenger uses functions from the CHAINSTUFF unit 
provided by Apple, so a copy of SYSTEM.LIBRARY must be 
online. The library may be on the booted disk, or on the 
library disk under the name NESTAR.LIB if the ZAPPASCAL 
program has been used. See the NFS System Manager’s Manual, 
Section 5.7 (Publication No. LC20-0102-0) for information 
about SYSTEM.LIBRARY. 


The Messenger uses the Nestar CVAL convention, and can be 
instructed to chain to another program when it terminates, 
rather than exiting to the pascal command line. If the CVAL 
string is set to ’//program’ when the Messenger is entered, 
then ‘program’ will be executed when it exits. The CVAL 
string may be set by a program which uses SETCVAL, or it may 
be set by NESTAR.START by including a line in your startcmd 
file like 


CHAIN MAIL,//program 


See Appendix D for more information about the Nestar CVAL 
convention. 


The User’s Mail File 

As described in Section 1.3, every mail system user has a 
mail file in which may be stored copies of messages received 
and composed. The Messenger creates this NFS file the first 
time that a new user enters the mail system. The file is 
mounted automatically each time the user brings up the mail 
system. 


The Mail File Pathname 


The pathname of the Mail file consists of three parts: 


l. A prefix 
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2. User's indentification 
3. The name "MAIL" 


The default prefix is /MAIN/USERS. For example, a typical 
user's mail file might be: 


/MAIN/USERS/SMITH/MAIL 


The user's identification often consists of a first name, 
last name, or set of initials. As described below (Section 
7.5.2 ), the three parts of the pathname can be autoset at 
startup to values other than the defaults. 


7.3 The Newmail Directory 


Each message sent through the mail system exists as an NFS 
file with a pathname consisting of four parts. 


l. Prefix 

2. User identification 

3. The name "NEWMAIL" 

4. Message identification number 


The default prefix of each pathname is the same as for the 
MAIL file. The identification for incoming mail is the same 
as for the MAIL file. For outgoing mail, the identification 
is that of the recipient. In the case of multiple 
recipients and CCs, multiple files are created. The 
(default) third part of each pathname is NEWMAIL. The 
fourth part is an identification assigned to each message by 
the Messenger, which is unique to that message. 


In addition to creating a Mail file for each new user, the 
Messenger creates for each new user a directory with the 
pathname Prefix/UserID/NEWMAIL, in which will be listed any 
new messages received by the user. 


7.4 Mounting MAIL and NEWMAIL 





Each time that the mail system is brought up at a user 
station, the Messenger looks for and executes any mail 
commands in a Pascal file called DEFAULTS.TEXT on the user’s 
boot disk, and determines the identity of the user from 
DEFAULTS.TEXT or by asking 


Who are you? 
If no mail file exists for the user, the Messenger displays 


Not found: /MAIN/USERS/SMITH/MAIL 
There is no mail file for SMITH 
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Create one (Y/N)? 
For "yu. 


Mail file size will be 100 blocks 
OK (Y/N)? 


For a mail file of some other size, type in "N" and the 
Messenger will prompt 


Enter size in blocks: 


The size must be between 10 and 1000 blocks. Blocks are 512 
characters each (approximately 7 text lines). A filed 
message will use one or more blocks. A mail file for Smith 
will then be created (assuming that access rights for create 
exist) and the file will be mounted automatically each time 
that the Messenger is brought up by the user. 


The Messenger examines the user's newmail directory when the 
READ or CHECK commands are executed. Any files listed in 
Newmail will be reported as new messages. After a message is 
read, it is removed from the users NEWMAIL directory. 


Notice that all messages filed by the user are located in a 
single Mail file. However, each piece of received mail 
exists as a separate Network file, listed in the directory 
/Prefix/User/NEWMAIL. 


After the Messenger has determined the identity of the user, 
it looks for two free virtual drives upon which to mount the 
mail file and NEWMAIL files. If two virtual drives are not 
available, the Messenger will display mount information for 
all current virtual drives at that station and ask the user 
which drive can be used for Mail and Newmail: 


WELCOME TO THE MESSENGER, VERSION 2.0 
Today is Mon 29-Jun-1981 13:20:00 
For help type ? RETURN to any request 

Who are you? SMITH 
NAME DRV ACCESS T VOL SIZE 
/MAIN/USERS/SMITH/1 

4 RW UPDP 1 560B 
/MAIN/PASCAL/LIB P 1 

5 RO SHR P 1 1800B 
/MAIN/ USERS/SMITH/DOC 

9 RW UPD D 2 500B 
/MAIN/ USERS/SMITH/2 

10 RO SHRP 1 400B 
/MAIN/ USERS/SMITH/MSQ 

11 RW EXC P 1 800B 
/MAIN/ USERS/SMITH/3 
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12 RO SHRP 1 800B 
Available drive number? 12 


Here, the user SMITH has volumes mounted on all available 
virtual drives (3 and 6-8 have not been set virtual). The 
Messenger establishes the identity of the user, locates the 
Network file with the pathname /MAIN/USERS/SMITH/MAIL if it 
exists, or creates it if it does not, and attempts to mount 
it on a free virtual drive. Since all virtual drives are in 
use, the Messenger asks for a drive that can be unmounted, 
or for a drive currently set real that can be set virtual. 
Here, SMITH indicates that drive #12 may be used. The 
Messenger mounts /MAIN/USERS/SMITH/MAIL on drive 12, with 
Read/Write, UPDATE usage. 


The Messenger now repeats the prompt 


NAME DRV ACCESS T VOL SIZE 
/MAIN/USERS/SMITH/1 

4 RW UDP 1 560B 
/MAIN/PASCAL/LIB P 1 

5 RO SHR P 1 1800B 
/MAIN/USERS/SMITH/DOC 

9 RW UPDD 2 500B 


/MAIN/USERS /SMITH/2 

10 RO SHRP 1 400B 
/MAIN/ USERS /SMITH/MSQ 

11 RW EXCP | 800B 
/ MAIN/USERS/SMITH/MAIL 


12 RW UPDP 1 100B 
Available drive number? ll 
Command? 


in order to free a drive for any new mail that may have been 
"sent" to the user (that is, created as a new file to be 
mounted) and for mail that is to be sent. In the example 
above, new mail, listed in the directory 
/MAIN/USERS/SMITH/NEWMAIL, will be mounted on drive 1l, 
message by message, in response to the command READ. Drive 
11 will also be used when outgoing mail is composed and 
sent. 


NOTE: Drives 4 and 5 (the BOOT volume and shared Pascal 
library volume) can not be used for the MAIL and NEWMAIL 
files. 


If the Mail and Newmail volumes are unmounted while the mail 
system is in use (by using the NFS command, or by mounting 
Newmail on the same drive number as Mail, for example), the 
Messenger will be unable to file or receive mail. Issuing 
the File command from the Incoming or Outgoing mail menus 
will then result in an error message such as 
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7.5.1 


7.5.2 


FAILED READING BLOCK 4,D12, IORESULT=64 


since the file to be read or written into is not currently 
mounted. 


Note: The user may mount other volumes on the Mail and 
Newmail drives before exiting by using the NFS command mode. 
The Messenger will not remount volumes automatically when it 
is through. However, the user’s current default directory, 
which is saved and overridden by /Prefix/User/NEWMAIL during 
initialization, is restored when the Messenger exits. The 
change in default directory has observable effects only if 
NFS commands are executed from within the mail system. The 
NFS command Set Dir should not be used from the Messenger. 


Automatic Startup 


The Cluster/One Model A System has two startup command 
facilities that can be used to facilitate entry into the 
mail system: NESTAR.START and DEFAULTS.TEXT. 


NESTAR. START 


NESTAR.START is the program that may run automatically when 
the user station is booted. NESTAR.START first checks the 
booted disk for a file named SYSTEM.STARTUP. If present, 
SYSTEM.STARTUP is chained to. Otherwise, NESTAR.START 
attempts to read a file from the booted disk called 
STARTCMD.TEXT, and interprets each line as a command. 
Including the command "MAIL" in STARTCMD.TEXT will cause the 
mail system to be run automatically when the station is 
booted. Other commands such as ASK and ASK... PROMPT may be 
used with the MAIL command. 


NESTAR.START commands that do not relate to the mail system 
are described in detail in Section 8.2.2 of the NFS User’s 
Manual (Publication No. LC20-0101-0). 


DEFAULTS .TEXT 


When the Messenger is executed, its first action is to read 
the file DEFAULTS.TEXT, if it exists on the station’s boot 
volume. Command lines in this textfile that begin with the 
word "Mail:" are executed automatically. 


The following mail commands are allowed (all commands must 
be preceded by "mail:"; upper and lower case are allowed). 
Underlined values are variables input by the user: 
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be preceded by "mail:"; upper and lower case are allowed). 
Underlined values are variables input by the user: 


Mail: Set 


Mail: Set 


Mail: Set 


Mail: Set 


Mail: Set 


Mail: Set 


Mail: Set 


9/1/81 


User name 


Identifies the user as "name". The Messenger will mount 
/Prefix/Name/Mail and  /Prefix/Name/Newmail/MessageID 
automatically. A password may be included, in the form 
name :password. When the Set User command is present, 
the Messenger will not ask "Who are you?" at 
initialization. 


DriveA x 


Sets the drive used for filed mail to drive x; 
otherwise the Messenger looks for any available drive. 
The drive must be virtual. 


DriveB y 


Sets the drive used to mount new mail to drive y; 
otherwise the Messenger looks for any available drive. 
The drive must be virtual. 


Height n 


Sets screen page height to n lines; default is 24. 
When displaying messages, the Messenger asks MORE?(Y/N) 
after n lines. 


width n 


Sets screen width to n columns. Screen width will 
affect the formatting of some prompt lines. The default 
is 80. 


Prefix path 


Sets pathname prefix for mail and newmail files. 
Default is /MAIN/USERS. READ access must be provided 
for all directories in the prefix path. Passwords may 
be included. All users of the Messenger must have the 
same prefix and Newmail; otherwise, messages will not 
be sent correctly. 


Mailfile path 
Sets the complete pathname for Mailfile. This command 
overrides default pathname Prefix/User/Mail and uses 


the specified pathname. READ, WRITE access must be 
provided. Passwords may be used. 
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Mail: 


Mail: 


Mail: 
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Set Newmail name 


Sets final name of Newmail pathname, appended to 
Prefix/User/. Used for incoming and outgoing mail. 
Default is "NEWMAIL". DELETE and READ access must be 
provided for the NEWMAIL directory, and CREATE access 
must be provided for outgoing newmail directories. 
Passwords may be included. 


READ 


Causes the Messenger to automatically execute the READ 
command after initialization. 


CHECK 


Causes the Messenger to automatically execute the CHECK 
command after initialization. 


Access, Usage, and Protection 


Cluster/One file protection facilities are discussed in 
detail in Chapter 4 of the NFS User’s Manual (Publication 
No. LC20-0101-0). Briefly, the mail system user can prevent 
access to his Mail and Newmail files by setting passwords in 
the file pathnames and limiting public and group access 
rights to those files. From within the mail system, this is 
accomplished by issuing NFS PROTECT commands. For example, 


NFS PROTECT /MAIN/USERS/SMITH/NEWMAIL, 
P UBACC=C , GRPACC=, PRVACC=RWECD , PRVPW=XYZ 


causes the private password "xyz" to be set for Smith's 
Newmail file, and read and write access to be restricted to 
private use. No group access is allowed, but the public is 
given "create" access so that messages from other mail users 
can be created in the Newmail directory. The Mail file is 
accessed only by the user who owns it; there need be no 
public access to it at all. 


The following access must be provided for the system to 
function: 


l. READ access for Mail/Newmail prefix (all users must 
have the same prefix and Newmail). 


2. READ and WRITE access for your own Mailfile. 


3. DELETE and READ access for your own Newmail directory. 
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4. CREATE access for other Newmail directories. 


A private password, once it has been set, can be entered in 
several ways: 


l. By issuing a Network "SET PRVPW' command from the 
CMD program before the Messenger is used. 


2. By including the SET PRVPW command in the boot 
volume startcmd.text. 


3. By including the private password in the appropriate 
Mail Set commands in the boot volume Defaults.text. 


The system default is no protection. 
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Formal Definition of <messages> 


The symbol <messages> is used in the command description 
wherever the Messenger expects a specification of some 
subset of the messages in the mail file. The following is a 
formal recursive grammar specification of the syntax of 
<messages>. 


<messages> ::= 
ALL All the messages in MAIL 
<expr> A single message, by number 


<exprl >:<expr2> Message numbers from <exprl> to 
<expr2>, inclusive. 


<exprl>!<expr2>  <expr2> messages, starting with 
message number <exprl> 


@<classname> [IN <messages>] All messages in 
<messages> which are also in the 
class <classname>. IN ALL assumed if 
it is omitted. 


<expr> ::= <number> A specific message number 
L The last message 
F The first message 
. The current message 
N The next message (.+1) 
P The previous message (.-1) 
<exprl>+<expr2> The sum of two expressions 
(usually a message number 
plus a constant, like 
"RLI"), 
<expr>-<expr> The difference of two 
expressions (usually a 
message number minus a 
constant, like "L-1"). 


Multiple expressions are 
allowed and performed from 
the right: 1-2-3 = 1- (2-3) 
= 0. 
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<classname> :: <a 1-15 character name> 


ii 


<number> <a positive integer> 
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Pascal File Names 


Pascal file names are used in several places by the 
Messenger, including 


(1) For reading in the text of a message (%filename) 
(2) For writing message (WRITE command or menu option) 


(3) For the DEFAULTS file 


In all cases the file is a "text" file, that is, contains 
lines of ASCII text terminated by carriage return. The rules 
for constructing the name of the file are as follows: 


(1) If the supplied name ends with ".TEXT", use the 
P 
supplied name. 
(2) If the supplied name ends with ".", remove the "." 
and use the supplied name. 


(3) If neither of the above rules apply, add ".TEXT" to 
the supplied name. 


The file name obeys the standard Apple Pascal syntax and may 
contain a volume specification as well as a file name. Some 
valid example names are: 


Name Given Name Used 

mymail mymail.text 

temp :01dmsgs. text temp :oldmsgs.text 
smith :appointments. smith :appointments 
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Command Summary 


Command Level Section Description 
or Menu Item 


Sending and Receiving 


READ C 3.1 Read new mail 
N(ext) I 3.1.1 Read next piece of mail 
K(eep) I 34142 Keep a message in the In-basket 
CHECK C 3.2 Wait for new mail 

SEND, C 3.3 Send messages 

S(end) 0 3.3.2 Transmit newly composed message 
R(eceipt) O 3.3.1 Request receipt before delivery 
Filing ` 

F(ile) 1,0 4.2 File new mail 

CLASSIFY C 4.3 Index messages in mail file 
DECLASSIFY C 4.5 Remove message from class 
RENAME C 4.6 Change name of mail-file class 
SHOW CLASSES C,I,0 4.7 Display the current classes 
DELETE C 4,8 Delete messages from mail file 
UNDELETE C 4.9 Recover deleted messages 


mn nn nn nn - 22 nm nv mn nn - nn nm ——— nn nn —ÀÓ—À—Ó——Ó—————————————— — 


Using Filed Mail 


DISPLAY, C 5.1 Display filed mail 
D(isplay) I,0 3.3.1 Display current message 
HEADERS C 5.2 Display filed-mail headers 
ANSWER, C 5.3 Answer a filed message 
A(nswer) jd 32301 Answer current message 
FORWARD, C 5.4 Forward a new or filed message 
F(orward) I Jade l Forward current message 
RESEND C 5.5 Send a filed message 
WRITE, C 5.6 Write filed mail to Pascal file 
or print on local printer 
W(rite) 1,0 3.3.1 Write current mail 
PRINT, C 5.7 Print message on system printer 
P(rint) 1,0 3.3.1 Print current message 
Other 
CLEAR "€ 6.2 Clear the screen 
HELP C 6.3 Display a command summary 
uu O,I,0 6.4 Prompt for expected action 
NEWS G 6.5 Display news about the system 
INFO C 6.6 Display local information 
NFS C 6.7 Issue NFS commands 
SHOW C 6.8 Display misc. information 
QCUIT) C,1,0 6.9 Return to previous level 
C = Command Level I = Incoming Mail O = Outgoing Mail 
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The Nestar CVAL Convention 


Pascal Release 1.1 allows one program to chain to another, 
and provides for a global string called CVAL to be passed as 
a parameter. 


See Pages 2 and 3 of the "Addendum to the Apple Pascal 
Language Reference Manual" (Apple Part #031-0101-00) for a 
discussion of chaining programs in the Apple Pascal 
environment. To use these procedures in the NFS environment 
with the Nestar shared library, the line 


USES CHAINSTUFF; 


that immediately follows the Program heading must be 
replaced by 


USES (*$U PASCAL :NESTAR.LIB*) CHAINST UFF; 


The Nestar definition of the CVAL variable allows it to be 
used both to specify a series of program to be executed, and 
to supply parameters to those programs. Programs which obey 
this convention can thus be called as subroutines or be 
linked in a chain of consecutive program executions. 


The general format of the CVAL string as a program begins 
execution is: 


parm//program2, parm2//program3 ... 


where "parm" is a parameter that is being passed to the 
current program. When it terminates, programl is the next 
program to be executed, and it is passed the string starting 
with parm2. 


For example, if the CVAL string has the following value when 
program ABC is executed 


verbose//DEF,nosend 


then program ABC will be executed with "verbose" as a 
parameter, after which program DEF will be executed with 
"nosend" as a parameter. 


Complex CHAIN sequences may be implemented by programs which 
add to as well as remove names from the CVAL string. Two 


procedures that manipulate the CVAL string in accordance 
with this convention are shown here: 
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GETPARM (parm-string); 

This procedure sets "parm-string" to the parm provided to 
this program. In addition, if a CHAIN program name was 
given then a SETCHAIN is done (for this reason, GETPARM 
should be called even if the invoking program doesn’t 
expect/accept a parm). This procedure should only be called 
once per program since multiple calls will umstack multiple 
parm/program list entries. 


SETPARM (parm-string, program-name-string); 

This procedure sets the parm for the next program which will 
be executed. In addition, the program name of the program 
to be executed after the next program has completed can be 
specified (e.g., the program name could be the original 
program name to cause a "return" to the original program 
when the next program has completed). SETPARM always returns 
and multiple SETPARM calls are legal (to set up a list of 
programs to execute). 


PROCEDURE GETPARM (VAR PARM:STRING) : 


VAR 
P: INTEGER; 
CVAL „PGM :STRING; 


BEG IN 
GETCVAL (CVAL); 
P : POS (’//’,CVAL); (*find the end of our parm*) 
IF P = O THEN BEGIN 
PARM := CVAL; 
CVAL := 
END 
ELSE BEGIN 
PARM := COPY (CVAL,1,P-1); 
DELETE (CVAL,1,P+1); 
P := POS (’,’,CVAL); 
IF P = O THEN BEGIN 
PGM := CVAL; 
CVAL := 
END 
ELSE BEGIN 
PGM := COPY (CVAL,1,P-1); 
DELETE (CVAL,1,P) 


END; 
IF PGM <> '' THEN SETCHAIN (PGM); (* XCTL pgm name *) 
END; 
SETCVAL (CVAL) 
END; 


PROCEDURE SETPARM (PARM,PGM: STRING); 
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VAR 
CVAL: STRING; 


BEGIN 


GETCVAL (CVAL); 
SETCVAL (CONCAT (PARM,’//’ ,PGM,’,’,CVAL)) 
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READERS COMMENT FORM 


CLUSTER/ONE MODEL A 
NESTAR SYSTEMS, INCORPORATED 


You are encouraged to use this form to communicate to Nestar any 
problems, bugs or suggestions associated with Nestar products. 
Wé would like your comments on improving the system itself, as 
well as this documentation. 


Nestar installation location: 

Submitter’s name : 

Address : 
Nestar environment 

Model A or Model One: 

Hard disk size (if present): 

Number of user stations: 


Language used: 
Type of application: 


Description of problem or suggestion: 


Please mail this form to: 


Nestar Systems, Incorporated 
2535 E. Bayshore 
Palo Alto, California, 94303 


i 


READERS COMMENT FORM 


CLUSTER/ONE MODEL A 
NESTAR SYSTEMS, INCORPORATED 


You are encouraged to use this form to communicate to Nestar any 
problems, bugs or suggestions associated with Nestar products. 
We would like your comments on improving the system itself, as 
well as this documentation. 


Nestar installation location: 
Submitter’s name 
Address 
Nestar environment 
Model A or Model One: 
Hard disk size (if present): 
Number of user stations: 


Language used: 
Type of application: 


Description of problem or suggestion: 


Please mail this form to: 


Nestar Systems, Incorporated 
2585 E. Bayshore 
Palo Alto, California, 94303 


READERS COMMENT FORM 


CLUSTER/ONE MODEL A 
NESTAR SYSTEMS, INCORPORATED 


You are encouraged to use this form to communicate to Nestar any 
problems, bugs or suggestions associated with Nestar products. 
We would like your comments on improving the system itself, as 
well as this documentation. 


Nestar installation location: 
Submitter’s name 
Address $ 
Nestar environment 
Model A or Model One: 
Hard disk size (if present): 
Number of user stations: 


Language used: 
Type of application: 


Description of problem or suggestion: 


Please mail this forn to: 


Nestar Systems, Incorporated 
2585 E. Bayshore 
Palo Alto, California, 94303 
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